home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection 1998 Fall: Game Toolkit / Disc.iso / SDKs / QuickTime Mac / AIncludes / QD3DIO.a < prev    next >
Encoding:
Text File  |  1998-04-09  |  29.5 KB  |  1,086 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DIO.a
  3. ;
  4. ;    Contains:    QuickDraw 3D IO API                                                
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.4
  7. ;                Release:    QuickTime 3.0
  8. ;
  9. ;    Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        Please include the the file and version information (from above) with
  12. ;                the problem description.  Developers belonging to one of the Apple
  13. ;                developer programs can submit bug reports to:
  14. ;
  15. ;                    devsupport@apple.com
  16. ;
  17. ;
  18.     IF &TYPE('__QD3DIO__') = 'UNDEFINED' THEN
  19. __QD3DIO__ SET 1
  20.  
  21.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  22.     include 'QD3D.a'
  23.     ENDIF
  24.  
  25.     IF &TYPE('__QD3DDRAWCONTEXT__') = 'UNDEFINED' THEN
  26.     include 'QD3DDrawContext.a'
  27.     ENDIF
  28.     IF &TYPE('__QD3DVIEW__') = 'UNDEFINED' THEN
  29.     include 'QD3DView.a'
  30.     ENDIF
  31.  
  32. ; ******************************************************************************
  33. ; **                                                                              **
  34. ; **                                    Basic Types                                 **                                                    
  35. ; **                                                                              **
  36. ; ****************************************************************************
  37.  
  38. ; typedef unsigned char                 TQ3Uns8
  39.  
  40. ; typedef signed char                     TQ3Int8
  41.  
  42. ; typedef unsigned short                 TQ3Uns16
  43.  
  44. ; typedef signed short                     TQ3Int16
  45.  
  46. ; typedef unsigned long                 TQ3Uns32
  47.  
  48. ; typedef signed long                     TQ3Int32
  49.  
  50.     IF TARGET_RT_BIG_ENDIAN THEN
  51. TQ3Uns64                RECORD 0
  52. hi                         ds.l    1                ; offset: $0 (0)
  53. lo                         ds.l    1                ; offset: $4 (4)
  54. sizeof                     EQU *                    ; size:   $8 (8)
  55.                         ENDR
  56. TQ3Int64                RECORD 0
  57. hi                         ds.l    1                ; offset: $0 (0)
  58. lo                         ds.l    1                ; offset: $4 (4)
  59. sizeof                     EQU *                    ; size:   $8 (8)
  60.                         ENDR
  61.     ELSE
  62. TQ3Uns64                RECORD 0
  63. lo                         ds.l    1                ; offset: $0 (0)
  64. hi                         ds.l    1                ; offset: $4 (4)
  65. sizeof                     EQU *                    ; size:   $8 (8)
  66.                         ENDR
  67. TQ3Int64                RECORD 0
  68. lo                         ds.l    1                ; offset: $0 (0)
  69. hi                         ds.l    1                ; offset: $4 (4)
  70. sizeof                     EQU *                    ; size:   $8 (8)
  71.                         ENDR
  72.     ENDIF    ; TARGET_RT_BIG_ENDIAN
  73. ; typedef float                         TQ3Float32
  74.  
  75. ; typedef double                         TQ3Float64
  76.  
  77. ; typedef TQ3Uns32                         TQ3Size
  78.  
  79. ; ******************************************************************************
  80. ; **                                                                              **
  81. ; **                                    File Types                                 **
  82. ; **                                                                              **
  83. ; ****************************************************************************
  84.  
  85.  
  86. ; typedef long                            TQ3FileModeMasks
  87. kQ3FileModeNormal                EQU        0
  88. kQ3FileModeStream                EQU        $01
  89. kQ3FileModeDatabase                EQU        $02
  90. kQ3FileModeText                    EQU        $04
  91. ; typedef unsigned long                 TQ3FileMode
  92.  
  93. ; ******************************************************************************
  94. ; **                                                                              **
  95. ; **                                    Method Types                             **
  96. ; **                                                                              **
  97. ; ****************************************************************************
  98.  
  99. ; 
  100. ; *    IO Methods
  101. ; *
  102. ; *    The IO system treats all objects as groups of typed information.
  103. ; *    When you register your element or attribute, the "elementType" is the 
  104. ; *    binary type of your object, the "elementName" the ascii type.
  105. ; *    
  106. ; *    All objects in the metafile are made up of a "root" or parent object which
  107. ; *    defines the instantiated object type. You may define the format of your 
  108. ; *    data any way you wish as long as you use the primitives types above and the
  109. ; *    routines below.
  110. ; *
  111. ; *    Root Objects are often appended with additional child objects, called 
  112. ; *    subobjects. You may append your object with other QuickDraw 3D objects.
  113. ; *    
  114. ; *    Writing is straightforward: an object traverses itself any other objects 
  115. ; *    that make it up, then writes its own data. Writing uses two methods: 
  116. ; *    TQ3XObjectTraverseMethod and TQ3XObjectWriteMethod.
  117. ; *
  118. ; *    The TQ3XObjectTraverseMethod method should:
  119. ; *    + First, Determine if the data should be written 
  120. ; *        - if you don't want to write out your object after examining your
  121. ; *            data, return kQ3Success in your Traverse method without calling
  122. ; *            any other submit calls.
  123. ; *     + Next, calculate the size of your object on disk
  124. ; *     + Gather whatever state from the view you need to preserve
  125. ; *         - you may access the view state NOW, as the state of the
  126. ; *             view duing your TQ3XObjectWriteMethod will not be valid. You may
  127. ; *             pass a temporary buffer to your write method.
  128. ; *     + Submit your view write data using Q3View_SubmitWriteData
  129. ; *         - note that you MUST call this before any other "_Submit" call.
  130. ; *         - you may pass in a "deleteMethod" for your data. This method
  131. ; *             will be called whether or not your write method succeeds or fails.
  132. ; *     + Submit your subobjects to the view
  133. ; *     
  134. ; *     The TQ3XObjectWriteMethod method should:
  135. ; *     + Write your data format to the file using the primitives routines below.
  136. ; *         - If you passed a "deleteMethod" in your Q3View_SubmitWriteData, that
  137. ; *             method will be called upon exit of your write method.
  138. ; *
  139. ; *    Reading is less straightforward because your root object and
  140. ; *    any subobjects must be read inside of your TQ3XObjectReadDataMethod. There 
  141. ; *    is an implicit state contained in the file while reading, which you must 
  142. ; *    be aware of. When you first enter the read method, you must physically 
  143. ; *    read in your data format using the primitives routines until
  144. ; *    
  145. ; *    Q3File_IsEndOfData(file) == kQ3True
  146. ; *    
  147. ; *    Generally, your data format should be self-descriptive such that you do not
  148. ; *    need to call Q3File_IsEndOfData to determine if you are done reading. 
  149. ; *    However, this call is useful for determining zero-sized object or 
  150. ; *    determining the end of an object's data.
  151. ; *    
  152. ; *    Once you have read in all the data, you may collect subobjects. A metafile
  153. ; *    object ONLY has subobjects if it is in a container. The call
  154. ; *    
  155. ; *    Q3File_IsEndOfContainer(file)
  156. ; *    
  157. ; *    returns kQ3False if subobjects exist, and kQ3True if subobjects do not 
  158. ; *    exist.
  159. ; *    
  160. ; *    At this point, you may use
  161. ; *    
  162. ; *    Q3File_GetNextObjectType
  163. ; *    Q3File_IsNextObjectOfType
  164. ; *    Q3File_ReadObject
  165. ; *    Q3File_SkipObject
  166. ; *    
  167. ; *    to iterate through the subobjects until Q3File_IsEndOfContainer(file) 
  168. ; *    is kQ3True.
  169. ; * 
  170. ; 
  171.  
  172.  
  173. ; 
  174. ; * IO Methods
  175. ; 
  176.  
  177.  
  178. kQ3XMethodTypeObjectFileVersion    EQU        'vers'                ; version 
  179. kQ3XMethodTypeObjectTraverse    EQU        'trvs'                ; byte count 
  180. kQ3XMethodTypeObjectTraverseData EQU    'trvd'                ; byte count 
  181. kQ3XMethodTypeObjectWrite        EQU        'writ'                ; Dump info to file 
  182. kQ3XMethodTypeObjectReadData    EQU        'rddt'                ; Read info from file into buffer or, attach read data to parent 
  183. kQ3XMethodTypeObjectRead        EQU        'read'
  184. kQ3XMethodTypeObjectAttach        EQU        'attc'
  185. ; 
  186. ; *    TQ3XObjectTraverseMethod
  187. ; *
  188. ; *    For "elements" (meaning "attributes, too), you will be passed NULL for 
  189. ; *    object. Sorry, custom objects will be available in the next major revision.
  190. ; *
  191. ; *    The "data" is a pointer to your internal element data.
  192. ; *
  193. ; *    The view is the current traversal view.
  194. ; 
  195.  
  196. ; 
  197. ; *  TQ3XObjectTraverseDataMethod
  198. ; 
  199.  
  200. ; 
  201. ; *  TQ3XObjectWriteMethod
  202. ; 
  203.  
  204. ; 
  205. ; *  Custom object writing 
  206. ; 
  207.  
  208. ;
  209. ; extern TQ3Status Q3XView_SubmitWriteData(TQ3ViewObject view, TQ3Size size, void *data, TQ3XDataDeleteMethod deleteData)
  210. ;
  211.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  212.         IMPORT_CFM_FUNCTION Q3XView_SubmitWriteData
  213.     ENDIF
  214.  
  215. ;
  216. ; extern TQ3Status Q3XView_SubmitSubObjectData(TQ3ViewObject view, TQ3XObjectClass objectClass, unsigned long size, void *data, TQ3XDataDeleteMethod deleteData)
  217. ;
  218.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  219.         IMPORT_CFM_FUNCTION Q3XView_SubmitSubObjectData
  220.     ENDIF
  221.  
  222. ; 
  223. ; *  TQ3XObjectReadMethod
  224. ; 
  225.  
  226. ; 
  227. ; *    TQ3XObjectReadDataMethod
  228. ; *
  229. ; *  For "elements" (meaning "attributes", too), you must allocate stack space 
  230. ; *    and call Q3Set_Add on "parentObject", which is an TQ3SetObject.
  231. ; *
  232. ; *    Otherwise, parentObject is whatever object your element is a subobject of...
  233. ; 
  234.  
  235. ; 
  236. ; *  TQ3XObjectAttachMethod
  237. ; 
  238.  
  239.  
  240.  
  241. ; ******************************************************************************
  242. ; **                                                                              **
  243. ; **                                Versioning                                     **
  244. ; **                                                                              **
  245. ; ****************************************************************************
  246.  
  247. ; typedef unsigned long                 TQ3FileVersion
  248.  
  249.  
  250. ; ******************************************************************************
  251. ; **                                                                              **
  252. ; **                                File Routines                                 **
  253. ; **                                                                              **
  254. ; ****************************************************************************
  255.  
  256. ; 
  257. ; * Creation and accessors
  258. ; 
  259.  
  260. ;
  261. ; extern TQ3FileObject Q3File_New(void )
  262. ;
  263.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  264.         IMPORT_CFM_FUNCTION Q3File_New
  265.     ENDIF
  266.  
  267. ;
  268. ; extern TQ3Status Q3File_GetStorage(TQ3FileObject theFile, TQ3StorageObject *storage)
  269. ;
  270.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  271.         IMPORT_CFM_FUNCTION Q3File_GetStorage
  272.     ENDIF
  273.  
  274. ;
  275. ; extern TQ3Status Q3File_SetStorage(TQ3FileObject theFile, TQ3StorageObject storage)
  276. ;
  277.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  278.         IMPORT_CFM_FUNCTION Q3File_SetStorage
  279.     ENDIF
  280.  
  281. ; 
  282. ; * Opening, and accessing "open" state, closing/cancelling
  283. ; 
  284.  
  285. ;
  286. ; extern TQ3Status Q3File_OpenRead(TQ3FileObject theFile, TQ3FileMode *mode)
  287. ;
  288.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  289.         IMPORT_CFM_FUNCTION Q3File_OpenRead
  290.     ENDIF
  291.  
  292. ;
  293. ; extern TQ3Status Q3File_OpenWrite(TQ3FileObject theFile, TQ3FileMode mode)
  294. ;
  295.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  296.         IMPORT_CFM_FUNCTION Q3File_OpenWrite
  297.     ENDIF
  298.  
  299. ;
  300. ; extern TQ3Status Q3File_IsOpen(TQ3FileObject theFile, TQ3Boolean *isOpen)
  301. ;
  302.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  303.         IMPORT_CFM_FUNCTION Q3File_IsOpen
  304.     ENDIF
  305.  
  306. ;
  307. ; extern TQ3Status Q3File_GetMode(TQ3FileObject theFile, TQ3FileMode *mode)
  308. ;
  309.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  310.         IMPORT_CFM_FUNCTION Q3File_GetMode
  311.     ENDIF
  312.  
  313. ;
  314. ; extern TQ3Status Q3File_GetVersion(TQ3FileObject theFile, TQ3FileVersion *version)
  315. ;
  316.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  317.         IMPORT_CFM_FUNCTION Q3File_GetVersion
  318.     ENDIF
  319.  
  320. ;
  321. ; extern TQ3Status Q3File_Close(TQ3FileObject theFile)
  322. ;
  323.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  324.         IMPORT_CFM_FUNCTION Q3File_Close
  325.     ENDIF
  326.  
  327. ;
  328. ; extern TQ3Status Q3File_Cancel(TQ3FileObject theFile)
  329. ;
  330.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  331.         IMPORT_CFM_FUNCTION Q3File_Cancel
  332.     ENDIF
  333.  
  334. ; 
  335. ; * Writing (Application)
  336. ; 
  337.  
  338. ;
  339. ; extern TQ3Status Q3View_StartWriting(TQ3ViewObject view, TQ3FileObject theFile)
  340. ;
  341.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  342.         IMPORT_CFM_FUNCTION Q3View_StartWriting
  343.     ENDIF
  344.  
  345. ;
  346. ; extern TQ3ViewStatus Q3View_EndWriting(TQ3ViewObject view)
  347. ;
  348.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  349.         IMPORT_CFM_FUNCTION Q3View_EndWriting
  350.     ENDIF
  351.  
  352. ; 
  353. ; * Reading (Application)
  354. ; 
  355.  
  356. ;
  357. ; extern TQ3ObjectType Q3File_GetNextObjectType(TQ3FileObject theFile)
  358. ;
  359.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  360.         IMPORT_CFM_FUNCTION Q3File_GetNextObjectType
  361.     ENDIF
  362.  
  363. ;
  364. ; extern TQ3Boolean Q3File_IsNextObjectOfType(TQ3FileObject theFile, TQ3ObjectType ofType)
  365. ;
  366.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  367.         IMPORT_CFM_FUNCTION Q3File_IsNextObjectOfType
  368.     ENDIF
  369.  
  370. ;
  371. ; extern TQ3Object Q3File_ReadObject(TQ3FileObject theFile)
  372. ;
  373.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  374.         IMPORT_CFM_FUNCTION Q3File_ReadObject
  375.     ENDIF
  376.  
  377. ;
  378. ; extern TQ3Status Q3File_SkipObject(TQ3FileObject theFile)
  379. ;
  380.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  381.         IMPORT_CFM_FUNCTION Q3File_SkipObject
  382.     ENDIF
  383.  
  384. ;
  385. ; extern TQ3Boolean Q3File_IsEndOfData(TQ3FileObject theFile)
  386. ;
  387.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  388.         IMPORT_CFM_FUNCTION Q3File_IsEndOfData
  389.     ENDIF
  390.  
  391. ;
  392. ; extern TQ3Boolean Q3File_IsEndOfContainer(TQ3FileObject theFile, TQ3Object rootObject)
  393. ;
  394.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  395.         IMPORT_CFM_FUNCTION Q3File_IsEndOfContainer
  396.     ENDIF
  397.  
  398. ;
  399. ; extern TQ3Boolean Q3File_IsEndOfFile(TQ3FileObject theFile)
  400. ;
  401.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  402.         IMPORT_CFM_FUNCTION Q3File_IsEndOfFile
  403.     ENDIF
  404.  
  405. ;     
  406. ; *  External file references
  407. ; 
  408.  
  409. ;
  410. ; extern TQ3Status Q3File_MarkAsExternalReference(TQ3FileObject theFile, TQ3SharedObject sharedObject)
  411. ;
  412.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  413.         IMPORT_CFM_FUNCTION Q3File_MarkAsExternalReference
  414.     ENDIF
  415.  
  416. ;
  417. ; extern TQ3GroupObject Q3File_GetExternalReferences(TQ3FileObject theFile)
  418. ;
  419.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  420.         IMPORT_CFM_FUNCTION Q3File_GetExternalReferences
  421.     ENDIF
  422.  
  423. ;     
  424. ; *  Tracking editing in read-in objects with custom elements
  425. ; 
  426.  
  427. ;
  428. ; extern TQ3Status Q3Shared_ClearEditTracking(TQ3SharedObject sharedObject)
  429. ;
  430.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  431.         IMPORT_CFM_FUNCTION Q3Shared_ClearEditTracking
  432.     ENDIF
  433.  
  434. ;
  435. ; extern TQ3Boolean Q3Shared_GetEditTrackingState(TQ3SharedObject sharedObject)
  436. ;
  437.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  438.         IMPORT_CFM_FUNCTION Q3Shared_GetEditTrackingState
  439.     ENDIF
  440.  
  441. ;     
  442. ; *  Reading objects inside a group one-by-one
  443. ; 
  444.  
  445.  
  446. ; typedef long                            TQ3FileReadGroupStateMasks
  447. kQ3FileReadWholeGroup            EQU        0
  448. kQ3FileReadObjectsInGroup        EQU        $01
  449. kQ3FileCurrentlyInsideGroup        EQU        $02
  450. ; typedef unsigned long                 TQ3FileReadGroupState
  451.  
  452. ;
  453. ; extern TQ3Status Q3File_SetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState readGroupState)
  454. ;
  455.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  456.         IMPORT_CFM_FUNCTION Q3File_SetReadInGroup
  457.     ENDIF
  458.  
  459. ;
  460. ; extern TQ3Status Q3File_GetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState *readGroupState)
  461. ;
  462.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  463.         IMPORT_CFM_FUNCTION Q3File_GetReadInGroup
  464.     ENDIF
  465.  
  466.  
  467. ; 
  468. ; * Idling
  469. ; 
  470.  
  471. ;
  472. ; extern TQ3Status Q3File_SetIdleMethod(TQ3FileObject theFile, TQ3FileIdleMethod idle, const void *idleData)
  473. ;
  474.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  475.         IMPORT_CFM_FUNCTION Q3File_SetIdleMethod
  476.     ENDIF
  477.  
  478.  
  479. ; ******************************************************************************
  480. ; **                                                                              **
  481. ; **                                Primitives Routines                             **
  482. ; **                                                                              **
  483. ; ****************************************************************************
  484.  
  485. ;
  486. ; extern TQ3Status Q3NewLine_Write(TQ3FileObject theFile)
  487. ;
  488.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  489.         IMPORT_CFM_FUNCTION Q3NewLine_Write
  490.     ENDIF
  491.  
  492. ;
  493. ; extern TQ3Status Q3Uns8_Read(TQ3Uns8 *data, TQ3FileObject theFile)
  494. ;
  495.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  496.         IMPORT_CFM_FUNCTION Q3Uns8_Read
  497.     ENDIF
  498.  
  499. ;
  500. ; extern TQ3Status Q3Uns8_Write(TQ3Uns8 data, TQ3FileObject theFile)
  501. ;
  502.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  503.         IMPORT_CFM_FUNCTION Q3Uns8_Write
  504.     ENDIF
  505.  
  506. ;
  507. ; extern TQ3Status Q3Uns16_Read(TQ3Uns16 *data, TQ3FileObject theFile)
  508. ;
  509.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  510.         IMPORT_CFM_FUNCTION Q3Uns16_Read
  511.     ENDIF
  512.  
  513. ;
  514. ; extern TQ3Status Q3Uns16_Write(TQ3Uns16 data, TQ3FileObject theFile)
  515. ;
  516.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  517.         IMPORT_CFM_FUNCTION Q3Uns16_Write
  518.     ENDIF
  519.  
  520. ;
  521. ; extern TQ3Status Q3Uns32_Read(TQ3Uns32 *data, TQ3FileObject theFile)
  522. ;
  523.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  524.         IMPORT_CFM_FUNCTION Q3Uns32_Read
  525.     ENDIF
  526.  
  527. ;
  528. ; extern TQ3Status Q3Uns32_Write(TQ3Uns32 data, TQ3FileObject theFile)
  529. ;
  530.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  531.         IMPORT_CFM_FUNCTION Q3Uns32_Write
  532.     ENDIF
  533.  
  534. ;
  535. ; extern TQ3Status Q3Int8_Read(TQ3Int8 *data, TQ3FileObject theFile)
  536. ;
  537.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  538.         IMPORT_CFM_FUNCTION Q3Int8_Read
  539.     ENDIF
  540.  
  541. ;
  542. ; extern TQ3Status Q3Int8_Write(TQ3Int8 data, TQ3FileObject theFile)
  543. ;
  544.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  545.         IMPORT_CFM_FUNCTION Q3Int8_Write
  546.     ENDIF
  547.  
  548. ;
  549. ; extern TQ3Status Q3Int16_Read(TQ3Int16 *data, TQ3FileObject theFile)
  550. ;
  551.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  552.         IMPORT_CFM_FUNCTION Q3Int16_Read
  553.     ENDIF
  554.  
  555. ;
  556. ; extern TQ3Status Q3Int16_Write(TQ3Int16 data, TQ3FileObject theFile)
  557. ;
  558.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  559.         IMPORT_CFM_FUNCTION Q3Int16_Write
  560.     ENDIF
  561.  
  562. ;
  563. ; extern TQ3Status Q3Int32_Read(TQ3Int32 *data, TQ3FileObject theFile)
  564. ;
  565.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  566.         IMPORT_CFM_FUNCTION Q3Int32_Read
  567.     ENDIF
  568.  
  569. ;
  570. ; extern TQ3Status Q3Int32_Write(TQ3Int32 data, TQ3FileObject theFile)
  571. ;
  572.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  573.         IMPORT_CFM_FUNCTION Q3Int32_Write
  574.     ENDIF
  575.  
  576. ;
  577. ; extern TQ3Status Q3Uns64_Read(TQ3Uns64 *data, TQ3FileObject theFile)
  578. ;
  579.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  580.         IMPORT_CFM_FUNCTION Q3Uns64_Read
  581.     ENDIF
  582.  
  583. ;
  584. ; extern TQ3Status Q3Uns64_Write(TQ3Uns64 data, TQ3FileObject theFile)
  585. ;
  586.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  587.         IMPORT_CFM_FUNCTION Q3Uns64_Write
  588.     ENDIF
  589.  
  590. ;
  591. ; extern TQ3Status Q3Int64_Read(TQ3Int64 *data, TQ3FileObject theFile)
  592. ;
  593.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  594.         IMPORT_CFM_FUNCTION Q3Int64_Read
  595.     ENDIF
  596.  
  597. ;
  598. ; extern TQ3Status Q3Int64_Write(TQ3Int64 data, TQ3FileObject theFile)
  599. ;
  600.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  601.         IMPORT_CFM_FUNCTION Q3Int64_Write
  602.     ENDIF
  603.  
  604. ;
  605. ; extern TQ3Status Q3Float32_Read(TQ3Float32 *data, TQ3FileObject theFile)
  606. ;
  607.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  608.         IMPORT_CFM_FUNCTION Q3Float32_Read
  609.     ENDIF
  610.  
  611. ;
  612. ; extern TQ3Status Q3Float32_Write(TQ3Float32 data, TQ3FileObject theFile)
  613. ;
  614.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  615.         IMPORT_CFM_FUNCTION Q3Float32_Write
  616.     ENDIF
  617.  
  618. ;
  619. ; extern TQ3Status Q3Float64_Read(TQ3Float64 *data, TQ3FileObject theFile)
  620. ;
  621.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  622.         IMPORT_CFM_FUNCTION Q3Float64_Read
  623.     ENDIF
  624.  
  625. ;
  626. ; extern TQ3Status Q3Float64_Write(TQ3Float64 data, TQ3FileObject theFile)
  627. ;
  628.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  629.         IMPORT_CFM_FUNCTION Q3Float64_Write
  630.     ENDIF
  631.  
  632. ;
  633. ; extern TQ3Size Q3Size_Pad(TQ3Size size)
  634. ;
  635.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  636.         IMPORT_CFM_FUNCTION Q3Size_Pad
  637.     ENDIF
  638.  
  639. ; 
  640. ; * Pass a pointer to a buffer of kQ3StringMaximumLength bytes
  641. ; 
  642.  
  643. ;
  644. ; extern TQ3Status Q3String_Read(char *data, unsigned long *length, TQ3FileObject theFile)
  645. ;
  646.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  647.         IMPORT_CFM_FUNCTION Q3String_Read
  648.     ENDIF
  649.  
  650. ;
  651. ; extern TQ3Status Q3String_Write(const char *data, TQ3FileObject theFile)
  652. ;
  653.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  654.         IMPORT_CFM_FUNCTION Q3String_Write
  655.     ENDIF
  656.  
  657. ;  
  658. ; * This call will read Q3Size_Pad(size) bytes,
  659. ; *    but only place size bytes into data.
  660. ; 
  661.  
  662. ;
  663. ; extern TQ3Status Q3RawData_Read(unsigned char *data, unsigned long size, TQ3FileObject theFile)
  664. ;
  665.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  666.         IMPORT_CFM_FUNCTION Q3RawData_Read
  667.     ENDIF
  668.  
  669. ;  
  670. ; * This call will write Q3Size_Pad(size) bytes,
  671. ; *    adding 0's to pad to the nearest 4 byte boundary.
  672. ; 
  673.  
  674. ;
  675. ; extern TQ3Status Q3RawData_Write(const unsigned char *data, unsigned long size, TQ3FileObject theFile)
  676. ;
  677.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  678.         IMPORT_CFM_FUNCTION Q3RawData_Write
  679.     ENDIF
  680.  
  681. ; ******************************************************************************
  682. ; **                                                                              **
  683. ; **                        Convenient Primitives Routines                         **
  684. ; **                                                                              **
  685. ; ****************************************************************************
  686.  
  687. ;
  688. ; extern TQ3Status Q3Point2D_Read(TQ3Point2D *point2D, TQ3FileObject theFile)
  689. ;
  690.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  691.         IMPORT_CFM_FUNCTION Q3Point2D_Read
  692.     ENDIF
  693.  
  694. ;
  695. ; extern TQ3Status Q3Point2D_Write(const TQ3Point2D *point2D, TQ3FileObject theFile)
  696. ;
  697.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  698.         IMPORT_CFM_FUNCTION Q3Point2D_Write
  699.     ENDIF
  700.  
  701. ;
  702. ; extern TQ3Status Q3Point3D_Read(TQ3Point3D *point3D, TQ3FileObject theFile)
  703. ;
  704.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  705.         IMPORT_CFM_FUNCTION Q3Point3D_Read
  706.     ENDIF
  707.  
  708. ;
  709. ; extern TQ3Status Q3Point3D_Write(const TQ3Point3D *point3D, TQ3FileObject theFile)
  710. ;
  711.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  712.         IMPORT_CFM_FUNCTION Q3Point3D_Write
  713.     ENDIF
  714.  
  715. ;
  716. ; extern TQ3Status Q3RationalPoint3D_Read(TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  717. ;
  718.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  719.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Read
  720.     ENDIF
  721.  
  722. ;
  723. ; extern TQ3Status Q3RationalPoint3D_Write(const TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  724. ;
  725.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  726.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Write
  727.     ENDIF
  728.  
  729. ;
  730. ; extern TQ3Status Q3RationalPoint4D_Read(TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  731. ;
  732.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  733.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Read
  734.     ENDIF
  735.  
  736. ;
  737. ; extern TQ3Status Q3RationalPoint4D_Write(const TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  738. ;
  739.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  740.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Write
  741.     ENDIF
  742.  
  743. ;
  744. ; extern TQ3Status Q3Vector2D_Read(TQ3Vector2D *vector2D, TQ3FileObject theFile)
  745. ;
  746.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  747.         IMPORT_CFM_FUNCTION Q3Vector2D_Read
  748.     ENDIF
  749.  
  750. ;
  751. ; extern TQ3Status Q3Vector2D_Write(const TQ3Vector2D *vector2D, TQ3FileObject theFile)
  752. ;
  753.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  754.         IMPORT_CFM_FUNCTION Q3Vector2D_Write
  755.     ENDIF
  756.  
  757. ;
  758. ; extern TQ3Status Q3Vector3D_Read(TQ3Vector3D *vector3D, TQ3FileObject theFile)
  759. ;
  760.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  761.         IMPORT_CFM_FUNCTION Q3Vector3D_Read
  762.     ENDIF
  763.  
  764. ;
  765. ; extern TQ3Status Q3Vector3D_Write(const TQ3Vector3D *vector3D, TQ3FileObject theFile)
  766. ;
  767.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  768.         IMPORT_CFM_FUNCTION Q3Vector3D_Write
  769.     ENDIF
  770.  
  771. ;
  772. ; extern TQ3Status Q3Matrix4x4_Read(TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  773. ;
  774.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  775.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Read
  776.     ENDIF
  777.  
  778. ;
  779. ; extern TQ3Status Q3Matrix4x4_Write(const TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  780. ;
  781.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  782.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Write
  783.     ENDIF
  784.  
  785. ;
  786. ; extern TQ3Status Q3Tangent2D_Read(TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  787. ;
  788.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  789.         IMPORT_CFM_FUNCTION Q3Tangent2D_Read
  790.     ENDIF
  791.  
  792. ;
  793. ; extern TQ3Status Q3Tangent2D_Write(const TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  794. ;
  795.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  796.         IMPORT_CFM_FUNCTION Q3Tangent2D_Write
  797.     ENDIF
  798.  
  799. ;
  800. ; extern TQ3Status Q3Tangent3D_Read(TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  801. ;
  802.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  803.         IMPORT_CFM_FUNCTION Q3Tangent3D_Read
  804.     ENDIF
  805.  
  806. ;
  807. ; extern TQ3Status Q3Tangent3D_Write(const TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  808. ;
  809.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  810.         IMPORT_CFM_FUNCTION Q3Tangent3D_Write
  811.     ENDIF
  812.  
  813. ;     This call affects only text Files - it is a no-op in binary files 
  814. ;
  815. ; extern TQ3Status Q3Comment_Write(char *comment, TQ3FileObject theFile)
  816. ;
  817.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  818.         IMPORT_CFM_FUNCTION Q3Comment_Write
  819.     ENDIF
  820.  
  821. ; ******************************************************************************
  822. ; **                                                                              **
  823. ; **                                Unknown Object                                 **
  824. ; **                                                                              **
  825. ; **        Unknown objects are generated when reading files which contain         **
  826. ; **        custom data which has not been registered in the current             **
  827. ; **        instantiation of QuickDraw 3D.                                         **
  828. ; **                                                                              **
  829. ; ****************************************************************************
  830.  
  831. ;
  832. ; extern TQ3ObjectType Q3Unknown_GetType(TQ3UnknownObject unknownObject)
  833. ;
  834.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  835.         IMPORT_CFM_FUNCTION Q3Unknown_GetType
  836.     ENDIF
  837.  
  838. ;
  839. ; extern TQ3Status Q3Unknown_GetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean *isDirty)
  840. ;
  841.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  842.         IMPORT_CFM_FUNCTION Q3Unknown_GetDirtyState
  843.     ENDIF
  844.  
  845. ;
  846. ; extern TQ3Status Q3Unknown_SetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean isDirty)
  847. ;
  848.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  849.         IMPORT_CFM_FUNCTION Q3Unknown_SetDirtyState
  850.     ENDIF
  851.  
  852.  
  853. ; ******************************************************************************
  854. ; **                                                                              **
  855. ; **                            Unknown Text Routines                             **
  856. ; **                                                                              **
  857. ; ****************************************************************************
  858.  
  859. TQ3UnknownTextData        RECORD 0
  860. objectName                 ds.l    1                ; offset: $0 (0)        ;  '\0' terminated 
  861. contents                 ds.l    1                ; offset: $4 (4)        ;  '\0' terminated 
  862. sizeof                     EQU *                    ; size:   $8 (8)
  863.                         ENDR
  864. ;
  865. ; extern TQ3Status Q3UnknownText_GetData(TQ3UnknownObject unknownObject, TQ3UnknownTextData *unknownTextData)
  866. ;
  867.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  868.         IMPORT_CFM_FUNCTION Q3UnknownText_GetData
  869.     ENDIF
  870.  
  871. ;
  872. ; extern TQ3Status Q3UnknownText_EmptyData(TQ3UnknownTextData *unknownTextData)
  873. ;
  874.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  875.         IMPORT_CFM_FUNCTION Q3UnknownText_EmptyData
  876.     ENDIF
  877.  
  878.  
  879. ; ******************************************************************************
  880. ; **                                                                              **
  881. ; **                            Unknown Binary Routines                             **
  882. ; **                                                                              **
  883. ; ****************************************************************************
  884.  
  885. TQ3UnknownBinaryData    RECORD 0
  886. objectType                 ds.l    1                ; offset: $0 (0)
  887. size                     ds.l    1                ; offset: $4 (4)
  888. byteOrder                 ds.l    1                ; offset: $8 (8)
  889. contents                 ds.l    1                ; offset: $C (12)
  890. sizeof                     EQU *                    ; size:   $10 (16)
  891.                         ENDR
  892. ;
  893. ; extern TQ3Status Q3UnknownBinary_GetData(TQ3UnknownObject unknownObject, TQ3UnknownBinaryData *unknownBinaryData)
  894. ;
  895.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  896.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetData
  897.     ENDIF
  898.  
  899. ;
  900. ; extern TQ3Status Q3UnknownBinary_EmptyData(TQ3UnknownBinaryData *unknownBinaryData)
  901. ;
  902.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  903.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyData
  904.     ENDIF
  905.  
  906.  
  907. ;
  908. ; extern TQ3Status Q3UnknownBinary_GetTypeString(TQ3UnknownObject unknownObject, char **typeString)
  909. ;
  910.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  911.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetTypeString
  912.     ENDIF
  913.  
  914. ;
  915. ; extern TQ3Status Q3UnknownBinary_EmptyTypeString(char **typeString)
  916. ;
  917.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  918.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyTypeString
  919.     ENDIF
  920.  
  921. ; ******************************************************************************
  922. ; **                                                                              **
  923. ; **                            ViewHints routines                                 **
  924. ; **                                                                              **
  925. ; **        ViewHints are an object in a metafile to give you some hints on how     **
  926. ; **        to render a scene.    You may create a view with any of the objects     **
  927. ; **        retrieved from it, or you can just throw it away.                     **
  928. ; **                                                                              **
  929. ; **        To write a view hints to a file, create a view hints object from a     **
  930. ; **        view and write the view hints.                                         **
  931. ; **                                                                              **
  932. ; ****************************************************************************
  933.  
  934. ;
  935. ; extern TQ3ViewHintsObject Q3ViewHints_New(TQ3ViewObject view)
  936. ;
  937.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  938.         IMPORT_CFM_FUNCTION Q3ViewHints_New
  939.     ENDIF
  940.  
  941. ;
  942. ; extern TQ3Status Q3ViewHints_SetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject renderer)
  943. ;
  944.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  945.         IMPORT_CFM_FUNCTION Q3ViewHints_SetRenderer
  946.     ENDIF
  947.  
  948. ;
  949. ; extern TQ3Status Q3ViewHints_GetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject *renderer)
  950. ;
  951.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  952.         IMPORT_CFM_FUNCTION Q3ViewHints_GetRenderer
  953.     ENDIF
  954.  
  955. ;
  956. ; extern TQ3Status Q3ViewHints_SetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject camera)
  957. ;
  958.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  959.         IMPORT_CFM_FUNCTION Q3ViewHints_SetCamera
  960.     ENDIF
  961.  
  962. ;
  963. ; extern TQ3Status Q3ViewHints_GetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject *camera)
  964. ;
  965.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  966.         IMPORT_CFM_FUNCTION Q3ViewHints_GetCamera
  967.     ENDIF
  968.  
  969. ;
  970. ; extern TQ3Status Q3ViewHints_SetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject lightGroup)
  971. ;
  972.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  973.         IMPORT_CFM_FUNCTION Q3ViewHints_SetLightGroup
  974.     ENDIF
  975.  
  976. ;
  977. ; extern TQ3Status Q3ViewHints_GetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject *lightGroup)
  978. ;
  979.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  980.         IMPORT_CFM_FUNCTION Q3ViewHints_GetLightGroup
  981.     ENDIF
  982.  
  983. ;
  984. ; extern TQ3Status Q3ViewHints_SetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet attributeSet)
  985. ;
  986.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  987.         IMPORT_CFM_FUNCTION Q3ViewHints_SetAttributeSet
  988.     ENDIF
  989.  
  990. ;
  991. ; extern TQ3Status Q3ViewHints_GetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet *attributeSet)
  992. ;
  993.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  994.         IMPORT_CFM_FUNCTION Q3ViewHints_GetAttributeSet
  995.     ENDIF
  996.  
  997. ;
  998. ; extern TQ3Status Q3ViewHints_SetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  999. ;
  1000.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1001.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensionsState
  1002.     ENDIF
  1003.  
  1004. ;
  1005. ; extern TQ3Status Q3ViewHints_GetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1006. ;
  1007.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1008.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensionsState
  1009.     ENDIF
  1010.  
  1011. ;
  1012. ; extern TQ3Status Q3ViewHints_SetDimensions(TQ3ViewHintsObject viewHints, unsigned long width, unsigned long height)
  1013. ;
  1014.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1015.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensions
  1016.     ENDIF
  1017.  
  1018. ;
  1019. ; extern TQ3Status Q3ViewHints_GetDimensions(TQ3ViewHintsObject viewHints, unsigned long *width, unsigned long *height)
  1020. ;
  1021.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1022.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensions
  1023.     ENDIF
  1024.  
  1025. ;
  1026. ; extern TQ3Status Q3ViewHints_SetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  1027. ;
  1028.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1029.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMaskState
  1030.     ENDIF
  1031.  
  1032. ;
  1033. ; extern TQ3Status Q3ViewHints_GetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1034. ;
  1035.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1036.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMaskState
  1037.     ENDIF
  1038.  
  1039. ;
  1040. ; extern TQ3Status Q3ViewHints_SetMask(TQ3ViewHintsObject viewHints, const TQ3Bitmap *mask)
  1041. ;
  1042.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1043.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMask
  1044.     ENDIF
  1045.  
  1046. ;
  1047. ; extern TQ3Status Q3ViewHints_GetMask(TQ3ViewHintsObject viewHints, TQ3Bitmap *mask)
  1048. ;
  1049.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1050.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMask
  1051.     ENDIF
  1052.  
  1053. ;  Call Q3Bitmap_Empty when done with the mask    
  1054. ;
  1055. ; extern TQ3Status Q3ViewHints_SetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod clearMethod)
  1056. ;
  1057.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1058.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageMethod
  1059.     ENDIF
  1060.  
  1061. ;
  1062. ; extern TQ3Status Q3ViewHints_GetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod *clearMethod)
  1063. ;
  1064.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1065.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageMethod
  1066.     ENDIF
  1067.  
  1068. ;
  1069. ; extern TQ3Status Q3ViewHints_SetClearImageColor(TQ3ViewHintsObject viewHints, const TQ3ColorARGB *color)
  1070. ;
  1071.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1072.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageColor
  1073.     ENDIF
  1074.  
  1075. ;
  1076. ; extern TQ3Status Q3ViewHints_GetClearImageColor(TQ3ViewHintsObject viewHints, TQ3ColorARGB *color)
  1077. ;
  1078.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1079.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageColor
  1080.     ENDIF
  1081.  
  1082.  
  1083.  
  1084.     ENDIF ; __QD3DIO__ 
  1085.  
  1086.